Skip to content

docs: allow blank issues and drop stale Submit-a-Server reference - #115

Merged
its-mash merged 1 commit into
mainfrom
docs/follow-up-blank-issues-and-stale-copy
Apr 23, 2026
Merged

docs: allow blank issues and drop stale Submit-a-Server reference#115
its-mash merged 1 commit into
mainfrom
docs/follow-up-blank-issues-and-stale-copy

Conversation

@its-mash

Copy link
Copy Markdown
Member

Summary

Two follow-ups to PR #114 that were on the branch but didn't land in the squash merge. Fixing both in a small, self-contained PR.

1. blank_issues_enabled: true

config.yml shipped with blank_issues_enabled: false, which surfaces the structured issue templates correctly but hides the "Open a blank issue" link for non-maintainers. Maintainers can bypass that and open blank issues regardless; everyone else gets stuck on the chooser. Flipping to true lets anyone open a free-form issue from the bottom of the chooser when none of the templates fit.

2. Drop stale "Submit a Server template" reference

request-server.yml still tells users with a working JSON definition to use the "Submit a Server" template. That template was intentionally removed in PR #114 (issue forms can't open PRs, so routing contributors through an issue was slower and confusing). Re-pointing the hint directly at CONTRIBUTING.md's five-command quickstart, which is the actual fastest path.

Before:

If you already have a working definition, use the Submit a Server template (or open a PR) instead — that's the fastest path.

After:

If you already have a working definition, open a Pull Request instead — that's the fastest path. See CONTRIBUTING.md for the five-command quickstart.

Test plan

  • CI (Validate PR) should skip or no-op — this PR doesn't touch servers/.
  • GitHub's "New issue" chooser for this repo shows Open a blank issue link at the bottom for signed-in non-maintainer users.
  • The ?template=request-server.yml deep link no longer shows the stale text.

Two follow-ups that were part of PR #114's branch but did not make it
into the squash merge:

- `.github/ISSUE_TEMPLATE/config.yml` — flip `blank_issues_enabled`
  from `false` to `true` so anyone (not just maintainers) can open a
  blank issue from the "New issue" chooser. Without the flag, non-
  maintainers only see the structured templates.
- `.github/ISSUE_TEMPLATE/request-server.yml` — replace the outdated
  "use the Submit a Server template (or open a PR)" hint. The
  Submit-a-Server template was removed in the prior PR because issue
  forms can't create PRs; repoint readers straight at CONTRIBUTING.md's
  quickstart instead.

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
@its-mash
its-mash merged commit dbb5955 into main Apr 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant